home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / dstev.z / dstev
Encoding:
Text File  |  1998-10-30  |  2.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDSSSSTTTTEEEEVVVV((((3333FFFF))))                                                            DDDDSSSSTTTTEEEEVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DSTEV - compute all eigenvalues and, optionally, eigenvectors of a real
  10.      symmetric tridiagonal matrix A
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE DSTEV( JOBZ, N, D, E, Z, LDZ, WORK, INFO )
  14.  
  15.          CHARACTER     JOBZ
  16.  
  17.          INTEGER       INFO, LDZ, N
  18.  
  19.          DOUBLE        PRECISION D( * ), E( * ), WORK( * ), Z( LDZ, * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      DSTEV computes all eigenvalues and, optionally, eigenvectors of a real
  23.      symmetric tridiagonal matrix A.
  24.  
  25.  
  26. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  27.      JOBZ    (input) CHARACTER*1
  28.              = 'N':  Compute eigenvalues only;
  29.              = 'V':  Compute eigenvalues and eigenvectors.
  30.  
  31.      N       (input) INTEGER
  32.              The order of the matrix.  N >= 0.
  33.  
  34.      D       (input/output) DOUBLE PRECISION array, dimension (N)
  35.              On entry, the n diagonal elements of the tridiagonal matrix A.
  36.              On exit, if INFO = 0, the eigenvalues in ascending order.
  37.  
  38.      E       (input/output) DOUBLE PRECISION array, dimension (N)
  39.              On entry, the (n-1) subdiagonal elements of the tridiagonal
  40.              matrix A, stored in elements 1 to N-1 of E; E(N) need not be set,
  41.              but is used by the routine.  On exit, the contents of E are
  42.              destroyed.
  43.  
  44.      Z       (output) DOUBLE PRECISION array, dimension (LDZ, N)
  45.              If JOBZ = 'V', then if INFO = 0, Z contains the orthonormal
  46.              eigenvectors of the matrix A, with the i-th column of Z holding
  47.              the eigenvector associated with D(i).  If JOBZ = 'N', then Z is
  48.              not referenced.
  49.  
  50.      LDZ     (input) INTEGER
  51.              The leading dimension of the array Z.  LDZ >= 1, and if JOBZ =
  52.              'V', LDZ >= max(1,N).
  53.  
  54.      WORK    (workspace) DOUBLE PRECISION array, dimension (max(1,2*N-2))
  55.              If JOBZ = 'N', WORK is not referenced.
  56.  
  57.      INFO    (output) INTEGER
  58.              = 0:  successful exit
  59.              < 0:  if INFO = -i, the i-th argument had an illegal value
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDSSSSTTTTEEEEVVVV((((3333FFFF))))                                                            DDDDSSSSTTTTEEEEVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.              > 0:  if INFO = i, the algorithm failed to converge; i off-
  75.              diagonal elements of E did not converge to zero.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.